home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / msdos / lynx / source / www / library / implemen / sgml.h < prev    next >
Encoding:
C/C++ Source or Header  |  1994-10-25  |  5.9 KB  |  199 lines
  1. /*                                                SGML parse and stream definition for libwww
  2.                                SGML AND STRUCTURED STREAMS
  3.                                              
  4.    The SGML parser is a state machine. It is called for every character
  5.    
  6.    of the input stream. The DTD data structure contains pointers
  7.    
  8.    to functions which are called to implement the actual effect of the
  9.    
  10.    text read. When these functions are called, the attribute structures pointed to by the
  11.    DTD are valid, and the function is passed a pointer to the curent tag structure, and an
  12.    "element stack" which represents the state of nesting within SGML elements.
  13.    
  14.    The following aspects are from Dan Connolly's suggestions:  Binary search, Strcutured
  15.    object scheme basically, SGML content enum type.
  16.    
  17.    (c) Copyright CERN 1991 - See Copyright.html
  18.    
  19.  */
  20. #ifndef SGML_H
  21. #define SGML_H
  22.  
  23. #include "HTUtils.h"
  24. #include "HTStream.h"
  25.  
  26. /*
  27.  
  28. SGML content types
  29.  
  30.  */
  31. typedef enum _SGMLContent{
  32.   SGML_EMPTY,    /* no content */
  33.   SGML_LITTERAL, /* character data. Recognised excat close tag only. litteral
  34.                     Old www server compatibility only! Not SGML */
  35.   SGML_CDATA,    /* character data. recognize </ only */
  36.   SGML_RCDATA,   /* replaceable character data. recognize </ and &ref; */
  37.   SGML_MIXED,    /* elements and parsed character data. recognize all markup */
  38.   SGML_ELEMENT   /* any data found will be returned as an error*/
  39.   } SGMLContent;
  40.  
  41.  
  42. typedef struct {
  43.     char *      name;           /* The (constant) name of the attribute */
  44.                                 /* Could put type info in here */
  45. } attr;
  46.  
  47.  
  48. /*              A tag structure describes an SGML element.
  49. **              -----------------------------------------
  50. **
  51. **
  52. **      name            is the string which comes after the tag opener "<".
  53. **
  54. **      attributes      points to a zero-terminated array
  55. **                      of attribute names.
  56. **
  57. **      litteral        determines how the SGML engine parses the charaters
  58. **                      within the element. If set, tag openers are ignored
  59. **                      except for that which opens a matching closing tag.
  60. **
  61. */
  62. typedef struct _tag HTTag;
  63. struct _tag{
  64.     char *      name;                   /* The name of the tag */
  65.     attr *      attributes;             /* The list of acceptable attributes */
  66.     int         number_of_attributes;   /* Number of possible attributes */
  67.     SGMLContent contents;               /* End only on end tag @@ */
  68. };
  69.  
  70.  
  71.  
  72.  
  73. /*              DTD Information
  74. **              ---------------
  75. **
  76. ** Not the whole DTD, but all this parser usues of it.
  77. */
  78. typedef struct {
  79.     HTTag *             tags;           /* Must be in strcmp order by name */
  80.     int                 number_of_tags;
  81.     CONST char **       entity_names;   /* Must be in strcmp order by name */
  82.     int                 number_of_entities;
  83. } SGML_dtd;
  84.  
  85.  
  86. /*      SGML context passed to parsers
  87. */
  88. typedef struct _HTSGMLContext *HTSGMLContext;   /* Hidden */
  89.  
  90.  
  91. /*__________________________________________________________________________
  92. */
  93.  
  94. /*
  95.  
  96. Structured Object definition
  97.  
  98.    A structured object is something which can reasonably be represented in SGML.  I'll
  99.    rephrase that.  A structured object is am ordered tree-structured arrangement of data
  100.    which is representable as text.The SGML parer outputs to a Structured object. A
  101.    Structured object can output its contents to another Structured Object. It's a kind of
  102.    typed stream. The architecure is largely Dan Conolly's. Elements and entities are
  103.    passed to the sob by number, implying a knowledge of the DTD. Knowledge of the SGML
  104.    syntax is not here, though.
  105.    
  106.    Superclass: HTStream
  107.    
  108.    The creation methods will vary on the type of Structured Object.Maybe the callerData is
  109.    enough info to pass along.
  110.    
  111.  */
  112. typedef struct _HTStructured HTStructured;
  113.  
  114. typedef struct _HTStructuredClass{
  115.  
  116.         char*  name;                            /* Just for diagnostics */
  117.  
  118.         void (*free) PARAMS((
  119.                 HTStructured*   me));
  120.  
  121.         void (*abort) PARAMS((
  122.                 HTStructured*   me,
  123.                 HTError         e));
  124.                 
  125.         void (*put_character) PARAMS((
  126.                 HTStructured*   me,
  127.                 char            ch));
  128.                                 
  129.         void (*put_string) PARAMS((
  130.                 HTStructured*   me,
  131.                 CONST char *    str));
  132.                 
  133.         void (*write) PARAMS((
  134.                 HTStructured*   me,
  135.                 CONST char *    str,
  136.                 int             len));
  137.                 
  138.         void (*start_element) PARAMS((
  139.                 HTStructured*   me,
  140.                 int             element_number,
  141.                 CONST BOOL*             attribute_present,
  142.                 CONST char**            attribute_value));
  143.                 
  144.         void (*end_element) PARAMS((
  145.                 HTStructured*   me,
  146.                 int             element_number));
  147.  
  148.         void (*put_entity) PARAMS((
  149.                 HTStructured*   me,
  150.                 int             entity_number));
  151.                 
  152. }HTStructuredClass;
  153.  
  154. /*
  155.  
  156. Find a Tag by Name
  157.  
  158.    Returns a pointer to the tag within the DTD.
  159.    
  160.  */
  161. extern HTTag * SGMLFindTag PARAMS((CONST SGML_dtd* dtd, CONST char * string));
  162.  
  163.  
  164. /*
  165.  
  166. Create an SGML parser
  167.  
  168.  */
  169. /*
  170. ** On entry,
  171. **      dtd             must point to a DTD structure as defined above
  172. **      callbacks       must point to user routines.
  173. **      callData        is returned in callbacks transparently.
  174. ** On exit,
  175. **              The default tag starter has been processed.
  176. */
  177.  
  178.  
  179. extern HTStream* SGML_new PARAMS((
  180.         CONST SGML_dtd *                dtd,
  181.         HTStructured *          target));
  182.  
  183. extern CONST HTStreamClass SGMLParser;
  184.  
  185.  
  186. #endif  /* SGML_H */
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. /*
  197.  
  198.     */
  199.